package idv.jieh.commons.sql;

/**
 * <p>Title: 藍色小惡魔的系統</p>
 * 這個介面定義資料庫連接的方法。<p>
 * 套件軟體經常必須和資料庫搭配使用，而需要替專案撰寫特定的資料庫的維護、控制程式。
 * 為了保持套件軟體資料庫使用的彈性，使套件軟體所需要存取的資料庫資源不受限制，
 * 我們在設計的時候，把資料庫連線資源的決定權交由專案狀況來控制。<p>
 * 套件軟體取得資料庫連線資源的方式，將會透過這個介面來與專案的物件交流。因此要實作專案中，
 * 負責管理資料庫連線資源的類別和方法。再把該類別實現後的物件傳給套件軟體中有需求的物件，
 * 這樣整個套件軟體就可以運作了。
 * </p>
 * @author Jieh
 * @version 1.0
 */

public interface DatabaseAdapter {

  /**
   * 定義取得資料庫連線資源的方法。<p>
   * @return 資料庫連線資源物件。
   */
  public java.sql.Connection getConnection();

  /**
   * 定義釋放資料庫連線資源的方法。<p>
   * @param c 需要被釋放的資料庫連線資源物件。
   * @return 釋放成功與否。true：成功；false：失敗。
   */
  public boolean freeConnection(java.sql.Connection c);

} // end interface DatabaseAdapter
